Skip to content

docs(AGENTS): add coordination modes (solo / subagent / agent team)#13

Merged
melon-claw merged 1 commit intomainfrom
chore/agents-md-coordination-modes
Apr 21, 2026
Merged

docs(AGENTS): add coordination modes (solo / subagent / agent team)#13
melon-claw merged 1 commit intomainfrom
chore/agents-md-coordination-modes

Conversation

@melon-claw
Copy link
Copy Markdown
Collaborator

@melon-claw melon-claw commented Apr 21, 2026

Summary

  • Mirrors the cfo-side three-mode decision rule (solo / subagent / agent team) enabled by the agent-teams feature.
  • Defers full guardrails to cfo AGENTS.md § Agent teams to avoid divergence.
  • Notes the library-specific caveat: release-tag PRs and PyPI-publish flows stay solo (no /resume restoration of in-process teammates makes a shell interruption a recovery risk).

Companion PR

melon-monarch-cfo#112 — full version with guardrails and concrete opportunities.

Why

Agent-teams feature is now live globally. Keeping the decision rule in AGENTS.md lets every fresh agent pick the right coordination mode from the file they already read first, and keeping the sibling-parity statement truthful requires the mirror.

Test plan

  • Pre-commit hooks pass locally.
  • No code paths touched; no behavior change.
  • code-reviewer verdict sentinel (APPROVED) posted before merge.
  • code-reviewer-gate CI check green.
  • Linear history (squash + delete branch on merge).

Mirrors the cfo-side three-mode decision rule enabled by the agent-teams
feature. Defers full guardrails to cfo AGENTS.md § Agent teams; notes the
library-specific caveat that release-tag and PyPI-publish flows stay solo
(no /resume restoration of in-process teammates makes a shell interruption
a recovery risk for publishing flows).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@melon-claw
Copy link
Copy Markdown
Collaborator Author

[code-reviewer] verdict: APPROVED
reviewed-sha: ba59301

Review — compact mirror of cfo three-mode rule

Docs-only AGENTS.md change. Inserts a "Coordination modes" table and a "Personas" subhead above the existing persona table. Full guardrails deferred to cfo AGENTS.md § Agent teams.

Round-1 blocker — RESOLVED via merge-order sequencing

Round-1 review flagged the #agent-teams anchor as dead until cfo#112 landed. cfo#112 merged at 2026-04-21T15:40:11Z (commit 0d1cdb8d) adding the ### Agent teams subsection, so the link now resolves to the intended anchor. No code change needed on this PR.

Consistency with cfo

  • Three-mode decision rule matches (solo / subagent / agent team).
  • "Don't use for" constraints are narrower-but-consistent with cfo (release-tag / publish runs are explicitly called out for this library; cfo calls out cloud-ops deploy runs).
  • Persona table preserved intact — no drift with PR docs(AGENTS): add quality-steward row + cross-repo scope note #11.

CI

  • gate: pass
  • lint + types + tests (py3.12): pass
  • pre-commit hooks: pass
  • code-reviewer-gate: pending this verdict; will re-evaluate.

@melon-claw melon-claw merged commit b4946c2 into main Apr 21, 2026
4 checks passed
@melon-claw melon-claw deleted the chore/agents-md-coordination-modes branch April 21, 2026 15:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant